home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 4 / BBS in a Box - Macintosh - Volume IV (January 1992) (BBS in a Box).iso / Files / Game / M / MacChase 2.0.cpt / MacChase 2.0 ƒ / MacChase 2.00 Docs (Text) < prev    next >
Encoding:
Text File  |  1991-04-12  |  17.1 KB  |  399 lines  |  [TEXT/MSWD]

  1. MacChase Version 2.00    3 February 1991
  2.  
  3.  
  4. -          -
  5. 1
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12. MacChase
  13.  
  14. Documentation
  15.  
  16.  
  17. 
  18.  
  19.  
  20.  
  21.  
  22.  
  23. Version 2.00    3 February 1991
  24. TABLE OF CONTENTS
  25.  
  26.                 Page
  27. 1    INTRODUCTION    2
  28.     1.1    About MacChase
  29.     1.2    Public Domain or Shareware?
  30.     1.3    Credits
  31. 2    ORDERING        3
  32.     2.1    Registration
  33.     2.2    Paid Registration
  34.     2.3    Documentation
  35.     2.4    Updates
  36.     2.5    Megamax C source code
  37. 3    DISTRIBUTION NOTICE    4
  38. 4    VERSION INFO    4
  39.     4.1    List of releases
  40.     4.2    Changes since last version
  41.     4.3    Future updates
  42.     4.4    Suggestions/Bug reports
  43. 5    NORMAL PLAY    6
  44. 6    APPLE MENU        6
  45.     6.1    About MacChase
  46.     6.2    About The Author
  47.     6.3    Desk Accessories
  48. 7    MAKING YOUR OWN MacChase GAME    7
  49.     7.1    Getting started making your own game
  50.     7.2    The editing mode
  51.     7.3    Saving levels
  52.     7.4    Next Level
  53.     7.5    Exiting the editing mode
  54.     7.6    Changing your game
  55.         7.6.1    Open Game...
  56.         7.6.2    Moving to other levels
  57.         7.6.3    Revert
  58.     7.7    Playing your games
  59. 8    GAME MENU        11
  60.     8.1    Start Game
  61.     8.2    Start at level...
  62.     8.3    Skip Level
  63.     8.4    High Scores
  64.     8.5    Clear Scores
  65.     8.6    Abort Game
  66.     8.7    Pause    
  67.     8.8    Score by Level
  68.     8.9    Sound
  69.     8.10    Beep Sound
  70. 9    MOVEMENT        12
  71. 10    OBJECT OF THE GAME    13
  72. 11    SCORING        13
  73. 12    SPEED            13
  74. 13    ORDER FORM        14
  75.  
  76. MacChase Version 2.00 Documentation
  77.  
  78. by Kevin L. Gong
  79.  
  80. 1    INTRODUCTION
  81.  
  82. 1.1    About MacChase
  83.     MacChase Version 2.00 is patterned after the arcade game, PacMan.  It includes such features as a top-twenty high-score list, a level-by-level evaluation of play, the ability to practice certain levels, and the ability to create new MacChase games.
  84.     MacChase has been tested on, and works on, a Mac 512K running System 4.1, a Mac SE running System 6.0.3, and a Mac SE/30 running System 6.0.5, and a Macintosh IIcx running System 6.0.7.  It is not known whether MacChase runs on other Macs, or with other system versions.
  85.     It should be noted that the game is MUCH faster on a Mac SE/30 and II.  Also, due to the nature of the newer Mac beeps, the beeps should probably be turned off (see Game menu).
  86.     MacChase was written in THINK C 4.0 by Kevin L. Gong.
  87.     MacChase is Copyright © 1991 Kevin L. Gong.
  88.  
  89. 1.2    Public Domain or Shareware?
  90.     My thanks to CD Fun House for rating MacChase version 1.75 two stars (OK), and calling it "a bit weak."  Seriously, though, I am glad to see it circulating.
  91.     However, there are only a handful of registered users.  I hope this improved version will see more users, and more registered users.  To that end, I have made MacChase a free program.  You may distribute it freely to friends, so long as you include the copyright notice.  However, if you use the program and would like improvements, please register as a MacChase user.  It costs nothing to register.  So it's FREE.
  92.     Use the order form at the end of this document to register (send no money if you're just registering).  Or, simply send a postcard with your name, address, Macintosh type and system configuration to:
  93.         Kevin L. Gong
  94.         MacChase 2.00 Registration
  95.         1302 Navellier St.
  96.         El Cerrito, CA 94530-2449
  97.     Please take the short time to send in the registration form or at least a postcard.  The programmer would truly like to know that the program is being used.  And the only way to know that is if users let him know.
  98.     Becoming a registered user will enable you to send for any of the things listed in the Ordering section.  You'll also get my personal thanks!
  99.     Also, if you are feeling generous, please send a check for $10 (payable to Kevin Gong) along with your registration sheet.  If you do so, you will become a paid registered user, and will enjoy added benefits.  Paid registered users will receive notices of any future software I create for the Macintosh, and free MacChase updates.
  100.     
  101. 1.3    Credits
  102. MacChase was written in THINK C 4.0.
  103.     THINK C 4.0 (1989), Symantec Corporation, 10201 Torre Avenue,
  104.     Cupertino, CA 95014, (408) 253-9600
  105. Sounds were recorded using the MacRecorder system.
  106.     MacRecorder, SoundEdit 2.0.2 (1990), Farallon Computing, Inc.,
  107.     Emeryville, CA
  108. The following two books were instrumental in the writing of MacChase:
  109.     Using the Macintosh TOOLBOX with C, by Jim Takatsuka, Fred Huxham,     and David Burnard published by SYBEX Inc., and
  110.  
  111.     C Primer Plus, by Mitchell Waite, Stephen Prata, and Donald Martin     published by Howard W. Sams & Co., Inc.  (this is a great book to learn C     from)
  112.  
  113.     Thanx to Jonathan Tanemori for suggesting allowing different movement keys (he didn't like "ikjl").
  114.  
  115.     Thanx also to Bob Nordling, Brian Foster, and all the great people who registered for previous versions of MacChase:  Eric Maldague, William Arveson, and Stan Yunker.
  116.  
  117. 2    ORDERING
  118.  
  119.     Orders should be sent using the order form at the end of this document.  Please include your name and address.  Make checks payable to Kevin L. Gong.  Orders should be sent to the following address:
  120.     Kevin L. Gong
  121.     1302 Navellier St.
  122.     El Cerrito, CA 94530-2449
  123.  
  124. 2.1    Registration    $0.00 (free!)
  125.     Entitles you to send for documentation, updates, and source code.
  126.  
  127. 2.2    Paid Registration    $10.00 donation
  128.     Free notification, by mail, of all future upgrades to MacChase, and other Macintosh software I write.  Also, you will receive automatic free upgrades mailed to you.
  129.  
  130. Note, only registered users (paid or unpaid) can send for the following 3 items.
  131.  
  132. 2.3    Documentation (hard-copy)    $5.00
  133.     In other words, the thing that you're reading right now.  This is basically free, but if you want a hard-copy and don't feeling like wasting your nice paper, ribbon, and wear and tear on your Imagewriter, I'll send you a hard-copy.  Please be sure to include a stamped (25 cents (or whatever it is by now), I'll add the rest) 8.5x11 (or a little larger) envelope.
  134.  
  135. 2.4    Updates (single-sided disk)    $5.00
  136.     These, again, are basically free.  However, if you don't have access to updates from a bulletin board service, you can send me for a disk.  Just send me a check and your mailing address, and I'll send you the next version as soon as it is finished.
  137.  
  138. 2.5    THINK C source code (hard-copy)    $15.00
  139.     For you programmers out there just starting out, I know how it feels.  I was there -- it's hard to just start out programming.  At least, I hope you're having trouble, 'cause I certainly did.  Crashes lurked around every corner.  Well, source code certainly would have helped.  So I'm making it available to C programmers for a small fee (part of that covers the cost of copying the source code, and most of the rest covers shipping).
  140.  
  141.  
  142. 3    DISTRIBUTION NOTICE
  143.  
  144.     Please distribute this to all of your Mac friends.  And, if there is one near you, send it off onto a BBS.
  145.     This program was first uploaded onto
  146.         BMUG BBS
  147.         (415) 849-BMUG    (849-2684)
  148.         300-1200-2400 Baud
  149.     Usage of BMUG BBS is free, but with limited usage for non-BMUG members.
  150.  
  151. 4    VERSION INFO
  152.  
  153. 4.1    List of releases
  154.  
  155.     A list of all releases of MacChase:
  156.  
  157.  
  158.     Version    Date Completed    Release Date
  159.     2.00    3 February 1991    3 February 1991
  160.     1.75    18 August 1988    18 August 1988
  161.     1.45+    18 August 1987    18 August 1987
  162.     1.45    16 August 1987    18 August 1987
  163.     1.37    1 August 1987    2 August 1987
  164.     1.36    19 August 1986    25 July 1987
  165.  
  166. 4.2    Changes since last version
  167.     •    revised and updated documentation
  168.     •    now written in THINK C 4.0 (before, was written in Megamax C)
  169.     •    does not crash when MC_Original not in same folder (gives friendly         error message instead)
  170.     •    added some new sounds
  171.     •    Can only open MacChase files (before, could open any TEXT files)
  172.     •    Only 1 file for storing games, rather than 3
  173.     •    Allow different keys for movement
  174.     •    Movement keys are really keys, rather than menus; in a related         change, command key must be pressed for menu shortcuts
  175.     •    Menus don't flash when updated
  176.     •    Screen updated when necessary
  177.     •    More Macintosh-standard dialog boxes
  178.     •    Power dot lasts a uniform amount of time.  Before, the faster the         speed, the longer it lasted.  No more.
  179.     •    things users won't visibly notice - lots of changes in source code         for manageability (updates may be easier to make)
  180.  
  181. 4.3    Future updates
  182.  
  183.     •    usage of even more standard Macintosh dialog boxes
  184.     •    faster, smoother graphics
  185.     •    more neat sounds
  186.     •    other goodies; some possibilities:
  187.         a two-player version!
  188.         selective eating -- only eat the power dots when you want to
  189.             (not just when you pass over it)
  190.         things you eat to speed you up or slow you down
  191.         larger, scrolling levels
  192.         All this and more if you register!
  193.  
  194.  
  195. 4.4    Suggestions/Bug reports
  196.  
  197.     If you have any changes you would like to see in MacChase, please send me a letter (or leave me a message on BMUG BBS if it is convenient).  Suggestions and comments are always welcome.
  198.     If you have any trouble with MacChase, please notify me immediately.  I'm not sure what systems it will work with.  Look in the Help menu, under Requirements, to find more about system configurations.  Send any bug reports, on either system usage, or general bugs in the program, to the same address as for ordering.
  199.  
  200.  
  201. 5    NORMAL PLAY
  202.  
  203.     If you simply want to play MacChase, without bothering with any of the niceties of the program, execute the following:
  204.     •    Enter the MacChase disk (complete with MacChase & MC_Original)
  205.     •    Run MacChase
  206.     •    Read the copyright notice and click in the button.
  207.     •    Select Start Game from the Game menu.
  208.     •    Begin playing.  The controls are i for up, j for left, k for down, and         l for right.  Eat all the dots on a level to reach the next level.  The         monsters will eat you unless they are shown with dots in their         centers, which will happen when you eat a solid black "power" dot.
  209.  
  210.  
  211.  
  212. APPLE MENU
  213.  
  214. 
  215.  
  216. 6.1    About MacChase
  217.     Shows the same notices you see at the beginning of the program.  This includes some introductory garbage, and some information on registering (please do) and ordering.
  218.  
  219. 6.2    About The Author
  220.     Shows some information about the author (who else?).
  221.  
  222. 6.3    (desk accessories)
  223.     The program works with most desk accessories, as far as I know  Please let me know if you have a desk accessory that does not work with MacChase.  I'd want to try to fix that.  If I can't, it would still be nice to let users know what doesn't work.
  224.  
  225. 7    MAKING YOUR OWN MacChase GAME
  226.  
  227.     Everything you need to use to make your own game is in the File and Editor menus.
  228. 7.1    Getting started making your own game
  229.  
  230. 
  231.  
  232.         First select Close Game to close the original game, then select         New Game to create your own, new game.  A game is a         simple TEXT document containing information about the levels         (walls, monsters, power dots, etc.) and a high scores list.          Selecting this item will cause the program to prompt you for the         name of this file.  After entering the file name you want and         clicking "Save," you are in the editing mode.  Or, press Cancel if         that suits you.  Try to remember that.
  233.  
  234. 7.2    The editing mode
  235.  
  236.     Once you're in the editing mode, there should be 8 buttons on the right     side of the window.  The level itself is surrounded by a black square     outline.  To put something on the level, select the appropriate button,     and click in the bordered area to place that object on the level.
  237.     The buttons:
  238.     
  239.     Start position
  240.         the starting position of the player, you!  This will appear as a solid         black square on the level.
  241.  
  242.     Reappear position
  243.         the place where monsters reappear after you kill them.  This will         appear as a cross.
  244.  
  245.     Monster
  246.         place where a monster starts.  You can place up to 5 monsters on         any one level.  They will appear as outlined squares (one-pixel         width lines).
  247.  
  248.     Power dot
  249.         you can place up to 5 power dots on any one level.  When a player         eats a power dot, he can kill the monsters.  Power dots are solid         black circles.
  250.  
  251.     Block square
  252.         make an entire square inaccessible to both monsters and the         player.  These will appear as heavily outlined squares filled gray.
  253.  
  254.     Horizontal line
  255.         make horizontal movement between two squares impossible.  A         line (thick) will appear above the mouse position.
  256.  
  257.     Vertical line
  258.         make vertical movement between two squares impossible.  A line         (thick) will appear to the left of the mouse position.
  259.  
  260.     Clear
  261.         erase an object (when you make mistakes)
  262.  
  263.     When you try to place an object on a square that is already occupied by a similar object, then that object will disappear.  This has the same effect as Clear, but it's more convenient.  In other cases, where the square is occupied by a different object, or no object at all, the appropriate object will be placed in the square.  The only exception is that the reappear zone may be placed in the same square as a power dot, a monster, or the player.
  264.  
  265. 7.3    Saving levels
  266.  
  267. 
  268.  
  269.     While still in the edit mode, select Save Level.
  270.  
  271. 7.4    Next Level
  272.  
  273.     When you've finished and have saved the level, you may proceed to the next level simply by selecting Next Level.  You will remain in the edit mode, and you will be given a clear screen to work with.
  274.  
  275. 7.5    Exiting the editing mode
  276.  
  277.     When you've saved everything, you can leave the editing mode by selecting Editor Off.  If you have not recently saved the level you have been working on, the program will ask you for confirmation.
  278.  
  279. 7.6    Changing your game
  280.  
  281.     7.6.1  Open Game...
  282.         edit an existing game.  Selecting this item will cause the program         to prompt you for an existing file name.  MacChase will then try to         open the file as a MacChase level.  The program will load the game         info, after which you may either play the game or turn on the         editor by selecting Editor On.
  283.  
  284.     7.6.2  Moving to other levels
  285.         You can move back and forth between levels by selecting Next         Level and Previous Level.
  286.  
  287.     7.6.3  Revert
  288.         If you edit a level and then decide that it was better the way it         was, you can revert to the last saved version of the level by         selecting Revert.
  289.  
  290. 7.7    Playing your games
  291.  
  292.     When you've finished making a game, you can play it by selecting Start Game.  The game will play exactly like the original list, whose name is MC_Original, which you can get back to playing by selecting Open Game and selecting that file, and then selecting Start Game.
  293.  
  294. 8    GAME MENU
  295.  
  296. 
  297.  
  298.  
  299.     From the Game menu, the following items can be selected:
  300.  
  301.     8.1  Start Game
  302.         start playing the current list
  303.  
  304.     8.2  Start at level...
  305.         start playing from a certain level (enter the number of the level).          Using this feature deprives a score from entering the top twenty.
  306.  
  307.     8.3  Skip Level
  308.         skip to the next level.  Using this feature deprives a score from         entering the top twenty.
  309.  
  310.     8.4  High Scores
  311.         lists the top twenty of the current list
  312.  
  313.     8.5  Clear Scores
  314.         clear the top twenty of the current list.  It will ask you for         confirmation before erasing previous scores.
  315.  
  316.     8.6  Abort Game
  317.         stops the game (not the program)
  318.  
  319.     8.7  Pause
  320.         pauses the game.  press any key to continue
  321.  
  322.     8.8  Score by Level
  323.         when this is checked, a list of your scores and number of men left         after each level will be given when you complete the game
  324.  
  325.     8.9  Sound
  326.         when this is checked, sound will accompany the game.  If it is not         checked, no sound will occur.
  327.  
  328.     8.10  Beep Sound
  329.         when this is checked, a beep will occur each time the player eats a         dot.  If it is not checked, no beeps will occur.
  330.  
  331. 9    MOVEMENT
  332.  
  333.     Pressing j moves you (the black square) left; k is down; l is right; and i     is up.  When moving, remember this:  pretend you're driving a car.  When     you want to turn, say, left, turn your blinker on halfway down the block.      In the game, that would mean pressing j before you reach the spot     where you want to turn.  That goes for all directions.
  334.  
  335.     For the picky game player, MacChase provides several movement     configurations.  The user can select any of the several selections under     the movement menu, and those keys will be the movement keys (the     first is the default, ikjl).  They are listed in order:  up, down, left,     right.
  336.  
  337.     In addition, you can always use the arrow keys.
  338.  
  339. 10    OBJECT OF THE GAME
  340.  
  341.     Eat all the dots on a level to reach the next level.  Avoid getting eaten by the monsters (white squares).  The only time they can't eat you is when they have a dot in their center.  This happens when you eat a power dot (solid black dot).  When the dot in the monsters' centers become outline instead of solid black, that means the dot is wearing off.  When it wears off, all the monsters you killed reappear. 
  342.  
  343. 11    SCORING
  344.  
  345.     1 point    Each framed dot
  346.     5 points    Each power dot (when you eat a power dot, you can         eat monsters)
  347.     10 points    Eating 1st monster
  348.     15 points    Eating 2nd monster
  349.     25 points    Eating 3rd monster
  350.     40 points    Eating 4th monster
  351.     60 points    Eating 5th monster
  352.  
  353.     bonus    you receive an extra man every 1000 points
  354.  
  355. 12    SPEED
  356.  
  357.     You can select any speed from SuperSlow to SuperFast.  You cannot     change the speed during play.  I usually play Fast or SuperFast.
  358.  
  359. ORDER FORM        Mail order form to:    Kevin L. Gong
  360.                 MacChase Registration
  361.                 1302 Navellier St.
  362.                 El Cerrito, CA 94530-2449
  363. From:
  364.     Name____________________________________________
  365.  
  366.     Address__________________________________________
  367.  
  368.     City, State, ZIP____________________________________
  369.  
  370.  
  371. Quantity    Item Description    Price
  372.  
  373.      1        Registration fee    $0.00 (free!)
  374.  
  375. _______    Donation (paid registration)    $10.00
  376.  
  377. _______    Documentation    $5.00
  378.  
  379. _______    Updates        $5.00
  380.  
  381. _______    C source code    $15.00
  382.  
  383.         Grand total    _______
  384.  
  385.  
  386. Please circle the appropriate information about the Macintosh you run MacChase on:
  387.  
  388.     Macintosh:  512KE     Plus     SE     II     Other______________
  389.  
  390.     System:   6.03   Other__________
  391.  
  392.     Other hardware (hard disks, accelerators, etc.):  __________________
  393.  
  394. Make checks payable to:       Kevin Gong
  395.  
  396. Please allow 1-2 weeks for shipping.  (if you don't get your order 3 weeks after you send it, send me a nasty letter)
  397.  
  398. If you're just registering, I'll send confirmation and my personal thanx.
  399.